home *** CD-ROM | disk | FTP | other *** search
/ Amiga CD-ROM Collection / Amiga CD-ROM Collection - Auge 4000 and Cactus and Demo Util.iso / auge4000 / 02 / help.text < prev    next >
Text File  |  1987-03-08  |  7KB  |  159 lines

  1. .t General
  2.                      General Information on the Explorer
  3.  
  4. This Mandelbrot Set Explorer computes and plots functions defined on the
  5. complex plane.  The functions are computed by repeatedly evaluating a
  6. complex polynomial until the magnitude of the value exceeds 2.0 or a maximum
  7. of 1000 iterations have been performed.  The number of iterations required
  8. to exceed the limit is the value that is plotted. Three different functions
  9. may be plotted. (See the "Function" menu item.) 
  10.  
  11. The Explorer translates the iteration count into a color and plots a pixel of
  12. that color at the point in the image that represents the point in the complex
  13. plane where the polynomial was evaluated.  Using the mouse you can select the
  14. region of the complex plane to be plotted and the size of the window to dis-
  15. play it in.  (See help on "Navigation".)  
  16.  
  17. Other options allow you to vary the mapping between iteration counts and
  18. plotted colors (See help on "Coloring", "Rainbows", and "Scaling".), the
  19. display mode, the whether a 2- or 3-dimensional view is plotted.
  20. .t Actions
  21.                              The "Actions" Menu
  22.  
  23. Help    - Displays help text such as this.
  24. Load    - Loads a previously saved image from disk.
  25. Save    - Saves the current image to disk as an ILBM file.  This file may be
  26.           read by a paint program such as DPaint. Partially plotted images 
  27.           may be saved. Plotting will be resumed when the image is reloaded.
  28. Print   - Prints the current image.  (Currently ignores preferences)
  29. Colors  
  30.   Load     - Loads the color pallette from any ILBM file, such as the image
  31.              and color files generated by the Explorer.
  32.   Save     - Saves the current color palette.
  33.   Display  - Opens a window on the screen that shows the current color
  34.              palette.  Selecting this item again, turns the window off.
  35. Reset
  36.   Window   - Resets the plotting area to the full screen.
  37.   Region   - Resets the plotted region to enclose the entire set.
  38.   Both     - Resets the window and the region.
  39. Banner  - Toggles the screen banner, which shows the plotting region.
  40. Quit    - Exits the Explorer.  There is no failsafe on this selection.
  41. .t Options
  42.                              Other Menu Options
  43.  
  44. Function  - Selects which function is to be plotted by the Explorer.
  45.  
  46. Screen    - Selects between high and low resolution and interlaced and
  47.             non-interlaced display modes.
  48.  
  49. Scale     - The Explorer uses a logrithmic function to map iteration counts
  50.             into the color to be plotted. With the scaling at /1, values
  51.             over 300 are assigned the color white, those over 1000 are 
  52.             assigned the color black, the rest use approximately two cycles
  53.             of the color palette. As you explore regions very close to the
  54.             set, the plots will get very "busy" unless you increase the
  55.             scale factor, which has the effect of assigning more counts to
  56.             the same color.
  57.  
  58. View      - Selects between a 2-dimensional or a 3-dimensional plot.
  59.  
  60. Plotting restarts after a Function, Screen, Scale, or View item is selected.
  61. The Window and Region are not affected.
  62. .t Navigation
  63.                           Navigating the Set
  64.  
  65. A <region> of the selected set is plotted in a <window> in the center of
  66. the screen. The region is defined in the banner [toggled by Right-Amiga-B].
  67. The screen outside the window is white.
  68.  
  69. You change the region and/or the size of the window by drawing a <rectangle>
  70. on the screen with the mouse:
  71.  
  72.  - Move the cursor to a corner of the rectangle and press the left button.
  73.  - While pressing the left button, drag the cursor to the opposite corner.
  74.  - Release the left button and a small "What's New" requester appears:
  75.    o Clicking <Window> causes the current region to be replotted the size of
  76.      the drawn rectangle.
  77.    o Clicking <Region> causes the region covered by the rectangle to be
  78.      redrawn in the current window.
  79.    o Clicking <Both> causes the region defined by the rectangle to be 
  80.      redrawn in the current window.
  81.  
  82. If the window and region have different aspect ratios, the region is 
  83. enlarged so that it has the same aspect ratio as the window.
  84. .t Coloring
  85.                           Coloring the Set
  86.  
  87. Scaled counts over 300 are always plotted in white. Counts over 1000 are
  88. always plotted in black.  The remaining counts are plotted from a palette
  89. of 29 (13 in hires) other colors, which you may redefine.
  90.  
  91. The palette of colors used to plot each set is controlled by keys on the
  92. keyboard. These are always active, so you can get instant feedback on the
  93. color settings.  The coloring of each set is very important in bringing
  94. out desired detail. (See also scaling.)
  95.  
  96. The palette is constructed by varying the intensity of the red, green, and
  97. blue portions of the color accross the color numbers according to a family
  98. of sine waves.  You can control the relative phasing of the red, green, and
  99. blue components, as well as the steepness of the curves.
  100.  
  101. You can also shift and permute the mapping between counts and colors.
  102.  
  103. The best way to learn how the keys work, is to bring up the "Colors" window
  104. using Right-Amiga-C and watch the changes as you press the keys.
  105. .t Rainbows
  106.                         Controling The Rainbow
  107.  
  108. The following keys control coloring
  109.  
  110. NKP-7,-4    Moves the point of highest Red intensity up and down in the
  111.             color map.
  112. NKP-8,-5    Moves the point of highest Green intensity up and down in the
  113.             color map.
  114. NKP-9,-6    Moves the point of highest Blue intensity up and down in the
  115.             color map.
  116.  
  117. (NKP stands for "Numeric Key Pad")
  118.  
  119. Left Arrow  Decreases the rate at which the intensity of the colors
  120.             diminishes as they get farther away from the point of highest
  121.             intensity.
  122. Right Arrow Increases the rate of change in intensity.
  123.  
  124. Up Arrow    Cycles the color map one position.
  125. Down Arrow  Cycles the color map one position in the opposite direction.
  126.  
  127. Space Bar   Permutes the color map.
  128. .t Scaling
  129.                                Scaling
  130.  
  131. /n means that the iteration count is divided by n before looking it up in
  132. the color map.
  133.  
  134. As a rule of thumb, the scaling should be set so that on the first pass of
  135. the plot, most of the pixels are colored.
  136. .t Hints
  137.                                 Hints
  138.  
  139.    -  To find a region you'd like to plot, start from the title image and
  140.       draw a rectangle around the region you'd like to see.  Select the
  141.       Region option on the What's New requester.  The screen will clear and
  142.       selected region will be plotted.  
  143.  
  144.    -  To see if it's the region you wanted, draw a small rectangle on the
  145.       screen and select the Window option on the What's New requester. The
  146.       selected region will now be drawn in the small window.
  147.  
  148.    -  If the region isn't centered properly, draw another rectangle that
  149.       covers the region you really want and select a new region.  This 
  150.       rectangle can overlap the borders of the window so it's possible to 
  151.       shift the plotted region in any direction.  If the rectangle is smaller
  152.       than the window, the new region will be enlarged, if it's larger,
  153.       the new region will be reduced.
  154.  
  155.    -  When you have the region you want, use the "Screen" menu to set the
  156.       display resolution, and then use the "Reset Window" item in the 
  157.       "Actions" menu to start a full screen plot.
  158.       
  159.